Skip to content

Cleanup content#378

Open
lucj wants to merge 27 commits intolayer5io:masterfrom
lucj:master
Open

Cleanup content#378
lucj wants to merge 27 commits intolayer5io:masterfrom
lucj:master

Conversation

@lucj
Copy link
Copy Markdown
Contributor

@lucj lucj commented Apr 8, 2026

This is currently a WIP

This brings the latest version of the Exoscale learning content to the Layer5 Academy.

@github-actions
Copy link
Copy Markdown

github-actions Bot commented Apr 8, 2026

🚀 Preview deployment: https://layer5io.github.io/exoscale-academy/pr-preview/pr-378/

Note: Preview may take a moment (GitHub Pages deployment in progress). Please wait and refresh. Track deployment here

@aabidsofi19
Copy link
Copy Markdown
Contributor

@lucj this looks good.

For the 12 newly added learning paths, you’ll need to generate their IDs in the cloud console and then use those IDs in the _index.md files.

Also, I noticed that most learning paths (except the workshops) are currently single-page. A proper learning path should have at least one dedicated page inside it. You can handle this in one of two ways:

Create a new leaf page with type: page inside each learning path, move the current index.md content into that page, and keep _index.md only for metadata (title, banner, tags, categories, etc.).
Alternatively, you could group these single-page learning paths under a single parent learning path, with each one as a separate course/page.

In general, _index.md should not contain the actual learning content—it should only hold metadata for the learning path.

For the learning and certification items that were removed, no action is needed in the console. They will be archived automatically.


[https://kubernetes.io/docs/reference/kubectl/generated/kubectl_delete/](https://kubernetes.io/docs/reference/kubectl/generated/kubectl_delete/)

## Solution
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Follow the old inline ## Exercise / ## Documentation / ## Solution, while new material in operations and challenges splits solutions into dedicated pages.
Example

Image

Use a consistent layout

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If this is ok for you, I'd update the exercises / solutions splits after the whole thing is released.


4. Delete the Pod

## Documentation
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Use a consistent layout

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not sure to get this one.

@@ -0,0 +1,96 @@
---
title: Solution
Copy link
Copy Markdown
Contributor

@CodexRaunak CodexRaunak Apr 13, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Use a specific title, this works in breadcrumbs, but it is weak in standalone navigation and search. Example "Challenge 4 Solution"

Image

Another pagination example (causing ambiguity)
image

Copy link
Copy Markdown
Contributor

@CodexRaunak CodexRaunak left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.


## Private Network

### Private Network
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

duplicates the section heading with two different heading levels


## Load Balancing

### Load Balancing
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

duplicates the section heading with two different heading levels

@lucj
Copy link
Copy Markdown
Contributor Author

lucj commented Apr 27, 2026

@lucj this looks good.

For the 12 newly added learning paths, you’ll need to generate their IDs in the cloud console and then use those IDs in the _index.md files.

Also, I noticed that most learning paths (except the workshops) are currently single-page. A proper learning path should have at least one dedicated page inside it. You can handle this in one of two ways:

Create a new leaf page with type: page inside each learning path, move the current index.md content into that page, and keep _index.md only for metadata (title, banner, tags, categories, etc.). Alternatively, you could group these single-page learning paths under a single parent learning path, with each one as a separate course/page.

In general, _index.md should not contain the actual learning content—it should only hold metadata for the learning path.

For the learning and certification items that were removed, no action is needed in the console. They will be archived automatically.

ok, I use index.md with a "page" type for the content, and _index.md for the metadata only.

@lucj
Copy link
Copy Markdown
Contributor Author

lucj commented Apr 27, 2026

I've updated the relative weights of the learning paths, but they are not listed in the correct order in the left menu and in the page. Any idea why ?

Capture d’écran 2026-04-27 à 16 35 00

@CodexRaunak
Copy link
Copy Markdown
Contributor

Hey @lucj
We have released another version of the academy-theme, please fetch the latest changes from upstream, it includes an instructor toolkit, where you can verify that the IDs are registered with the academy.

Here's is the demonstration of it:

@@ -0,0 +1,55 @@
# Kubernetes
pod: >
Copy link
Copy Markdown
Contributor

@CodexRaunak CodexRaunak Apr 27, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This file + folder data can be deleted as we have added the icons in the academy-theme v0.4.7

@lucj
Copy link
Copy Markdown
Contributor Author

lucj commented Apr 27, 2026

Hey @lucj We have released another version of the academy-theme, please fetch the latest changes from upstream, it includes an instructor toolkit, where you can verify that the IDs are registered with the academy.

Here's is the demonstration of it:

hey @CodexRaunak, I'm not sure to get this right as I've created the IDs for each of the 3 workshops, but the inspector tells me there are not there.

Capture d’écran 2026-04-27 à 17 04 33 Capture d’écran 2026-04-27 à 17 04 43

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looking good, @lucj. Ideally, this is a Meshery Design, embedded in the pages for both an enhanced learner experience - both getting to interact with the design/components as well as, ultimately, being able to deploy the design.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@lucj @CodexRaunak, the currently published form of the workshop and of the rest of the Exoscale content has a number of embedded Meshery designs. It'd be great to see the continuity of that work (for it not to be lost).

Here are a couple of examples from the current workshop content - https://exoscale.layer5.io/academy/learning-paths/1e2a8e46-937c-47ea-ab43-5716e3bcab2e/end-to-end-kubernetes/kubernetes-workshop/workshop/concepts/#how-to-access-a-cluster

Comment thread content/learning-paths/1e2a8e46-937c-47ea-ab43-5716e3bcab2e/Intro-K8S/_index.md Outdated
@CodexRaunak
Copy link
Copy Markdown
Contributor

@lucj could you please resolve these broken Broken Images at https://layer5io.github.io/exoscale-academy/pr-preview/pr-378/learning-paths/1e2a8e46-937c-47ea-ab43-5716e3bcab2e/intro-k8s/

@lucj
Copy link
Copy Markdown
Contributor Author

lucj commented Apr 29, 2026

@CodexRaunak are we good? :-)

lucj and others added 25 commits April 29, 2026 21:23
Signed-off-by: Luc Juggery <luc.juggery@gmail.com>
Signed-off-by: Luc Juggery <luc.juggery@gmail.com>
Signed-off-by: Luc Juggery <luc.juggery@gmail.com>
Signed-off-by: Luc Juggery <luc.juggery@gmail.com>
Signed-off-by: CodexRaunak <CodexRaunak@users.noreply.github.com>
Signed-off-by: Luc Juggery <luc.juggery@gmail.com>
Signed-off-by: saurabhraghuvanshii <saurabhsraghuvanshi@gmail.com>
Signed-off-by: Luc Juggery <luc.juggery@gmail.com>
Signed-off-by: Luc Juggery <luc.juggery@gmail.com>
Signed-off-by: Luc Juggery <luc.juggery@gmail.com>
Signed-off-by: Luc Juggery <luc.juggery@gmail.com>
Signed-off-by: Luc Juggery <luc.juggery@gmail.com>
Signed-off-by: Luc Juggery <luc.juggery@gmail.com>
Signed-off-by: Luc Juggery <luc.juggery@gmail.com>
Signed-off-by: Raunak Madan <143412156+CodexRaunak@users.noreply.github.com>
Signed-off-by: Luc Juggery <luc.juggery@gmail.com>
Simplified the preview deployment message format.

Signed-off-by: Raunak Madan <143412156+CodexRaunak@users.noreply.github.com>
Signed-off-by: Luc Juggery <luc.juggery@gmail.com>
Updated the message for preview deployment notification.

Signed-off-by: Raunak Madan <143412156+CodexRaunak@users.noreply.github.com>
Signed-off-by: Luc Juggery <luc.juggery@gmail.com>
Signed-off-by: Raunak Madan <143412156+CodexRaunak@users.noreply.github.com>
Signed-off-by: Luc Juggery <luc.juggery@gmail.com>
Signed-off-by: Raunak Madan <143412156+CodexRaunak@users.noreply.github.com>
Signed-off-by: Luc Juggery <luc.juggery@gmail.com>
Signed-off-by: CodexRaunak <CodexRaunak@users.noreply.github.com>
Signed-off-by: Luc Juggery <luc.juggery@gmail.com>
Signed-off-by: Luc Juggery <luc.juggery@gmail.com>
Signed-off-by: CodexRaunak <CodexRaunak@users.noreply.github.com>
Signed-off-by: Luc Juggery <luc.juggery@gmail.com>
Signed-off-by: Luc Juggery <luc.juggery@gmail.com>
Signed-off-by: Luc Juggery <luc.juggery@gmail.com>
Signed-off-by: Luc Juggery <luc.juggery@gmail.com>
Signed-off-by: Luc Juggery <luc.juggery@gmail.com>
Signed-off-by: Luc Juggery <luc.juggery@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants